What is @reach/portal?
@reach/portal is a React component that allows you to render children into a DOM node that exists outside the DOM hierarchy of the parent component. This is useful for creating modals, tooltips, and other UI elements that need to visually break out of their container.
What are @reach/portal's main functionalities?
Basic Portal Usage
This example demonstrates the basic usage of the @reach/portal package. The `Portal` component is used to render a div outside of the parent DOM hierarchy, which can be useful for creating modals or tooltips.
import React from 'react';
import { Portal } from '@reach/portal';
function App() {
return (
<div>
<h1>My App</h1>
<Portal>
<div style={{ position: 'absolute', top: 0, left: 0, background: 'white', border: '1px solid black' }}>
This is rendered in a portal!
</div>
</Portal>
</div>
);
}
export default App;
Nested Portals
This example shows how you can nest portals within each other. The nested `Portal` component renders its children outside of the parent DOM hierarchy, allowing for complex UI structures.
import React from 'react';
import { Portal } from '@reach/portal';
function App() {
return (
<div>
<h1>My App</h1>
<Portal>
<div style={{ position: 'absolute', top: 0, left: 0, background: 'white', border: '1px solid black' }}>
This is rendered in a portal!
<Portal>
<div style={{ position: 'absolute', top: 20, left: 20, background: 'lightgray', border: '1px solid black' }}>
This is a nested portal!
</div>
</Portal>
</div>
</Portal>
</div>
);
}
export default App;
Other packages similar to @reach/portal
react-dom
The `react-dom` package provides the `createPortal` method, which allows you to render children into a DOM node that exists outside the DOM hierarchy of the parent component. It is a core part of React and offers similar functionality to @reach/portal but is more integrated into the React ecosystem.
react-portal
The `react-portal` package is another popular library for creating portals in React. It offers a simple API and additional features like event handling and portal management. It is more feature-rich compared to @reach/portal but may be overkill for simple use cases.
react-reverse-portal
The `react-reverse-portal` package allows you to create portals that can be moved around the DOM dynamically. It provides more advanced features for managing portal content and is useful for complex applications that require dynamic portal management. It offers more flexibility compared to @reach/portal.
@reach/portal
![MIT license](https://badgen.now.sh/badge/license/MIT)
Docs | Source
Creates and appends a DOM node to the end of document.body
and renders a React tree into it. Useful for rendering a natural React element hierarchy with a different DOM hierarchy to prevent parent styles from clipping or hiding content (for popovers, dropdowns, and modals).
import Portal from "@reach/portal";
function Example() {
return (
<Portal>
<div>Stuff goes here</div>
</Portal>
);
}